home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / asmutil / asm_n_z.zip / PRINTER.DOC < prev    next >
Text File  |  1986-03-01  |  10KB  |  216 lines
  1.  
  2.  
  3.  
  4.                                  PRINTER.DOC                    Ver 1.1
  5.  
  6.                                  John Petrey
  7.                                   (c) 1983                                  
  8.  
  9.         This  is  the documentation file for the PRINTER.COM  program,  a 
  10.         program that allows one to easily use the special print functions 
  11.         for  their printer (any make).   PRINTER.COM is run by typing  in 
  12.         PRINTER at the DOS prompt or directly from Wordstar using the "R" 
  13.         (run a program) command.
  14.  
  15.         PRINTER.COM  is  used to set up your printer to make use of  it's 
  16.         special print functions (compressed print,  double strike  print, 
  17.         italics print,  etc.)  For example,   you may have a printer that 
  18.         normally only prints 80 characters on a line,  which is fine most 
  19.         of  the  time.   However,  you may find times when you'd like  to 
  20.         print more than 80 characters on a line.  You can use PRINTER.COM 
  21.         to tell your printer to use compressed print.    Likewise, if you  
  22.         normally use continuous form paper,  then you want the printer to 
  23.         stop printing  when it runs out of paper.   But when you want  to 
  24.         use  single sheet paper,  the printer stops because it thinks  it 
  25.         doesn't have any paper in the printer.   PRINTER.COM can tell the 
  26.         printer to temporarily ignore the paper out sensor so you can use 
  27.         single sheet paper.   Whatever your printer has the capability to 
  28.         do, you can easily do it with PRINTER.COM.
  29.  
  30.         To use PRINTER.COM you must set up a data file for PRINTER.COM to 
  31.         read  so it knows what special print functions you want  to  use. 
  32.         You  can enter up to ten different special print features in  the 
  33.         data  file.   The  data file must be named PRINTER.DAT  and  must 
  34.         conform  to  a specific format so PRINTER.COM can understand  it.  
  35.  
  36.         When you run  PRINTER.COM,  it looks for the  PRINTER.DAT file on 
  37.         the default disk drive unless you tell  PRINTER.COM  that the DAT
  38.         file is located on some other disk drive.    You tell PRINTER.COM
  39.         the drive the  DAT file is located on by typing in the disk drive
  40.         letter after you type in PRINTER at the DOS prompt.  For example,
  41.         if the  default  drive is  A  and  PRINTER.COM  is on drive B and   
  42.         PRINTER.DAT is on drive C, you would type in  B:PRINTER C  at the
  43.         DOS A> prompt so DOS would know to look on drive B for PRINTER.COM
  44.         and so PRINTER.COM would know to look on drive C for PRINTER.DAT.
  45.  
  46.         The  data file (PRINTER.DAT) must contain a description (literal) 
  47.         of  the special print features you want to be available  and  the 
  48.         printer  control  codes  for each  special  print  feature.   The 
  49.         control  codes  are listed in your printer's user manual and  are 
  50.         likely found in the back of the manual as an appendix.  A control 
  51.         code  is  nothing  more  than  a unique  code  that  the  printer 
  52.         recognizes as a command to change to a special print mode.
  53.          
  54.         Let's assume you have an Epson MX printer and want to be able  to 
  55.         set up the printer for compressed print.   According to the Epson 
  56.         manual  (appendix B in my Epson manual) the control code to  turn 
  57.         on  compressed print is 15 (the ASCII character 15).  To  set  up 
  58.         your  PRINTER.DAT  file for compressed print on an Epson  printer 
  59.         you would need an entry like the following:
  60.  
  61.              Compressed Print$015000
  62.  
  63.  
  64.                                   Page 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.         The  first  part  of the entry is what you want  printed  on  the 
  72.         screen,  Compressed Print in this case.  Following the literal is 
  73.         a  dollar sign ($) which tells PRINTER.COM where the end of  your 
  74.         literal is and where the beginning of the codes are that you want 
  75.         sent  to  the  printer to turn on  that  special  print  feature.  
  76.         Following the dollar sign are six digits which to PRINTER.COM are 
  77.         really  two three-digit numbers.   The first three digits in this 
  78.         case  are  015  which  will be sent to the  printer  to  turn  on 
  79.         compressed print.   The last three digits (000 in this case) will 
  80.         not  be  sent  to the printer because  it  is  000.   PRINTER.COM 
  81.         expects two three-digit numbers,  so in this case we had to enter 
  82.         000   as   one  of  the  two  three-digit  numbers   to   satisfy 
  83.         PRINTER.COM's  requirement  for two  three-digit  numbers.   Many 
  84.         special print functions require two control codes be sent to  the 
  85.         printer  in order to set up a special print function,  so that is 
  86.         why PRINTER.COM wants two-three digit numbers.   For example,  on 
  87.         the Epson Printer,  to set up Italics print you need to send  the 
  88.         printer  a  ESC (escape) and a 53 (according to my Epson  Printer 
  89.         manual,  Appendix  B).   You would enter  your  literal,  Italics 
  90.         Print,  followed by a dollar sign followed by 027053.  027 is the 
  91.         ASCII code for Escape  and  053 is the code  for  Italics.  Thus,  
  92.         the entry in the PRINTER.DAT file would look like:
  93.               
  94.               Italics Print$027053
  95.  
  96.         Up  to  ten different special print functions can be  entered  in 
  97.         the PRINTER.DAT file and each should be on separate  lines.   The 
  98.         last  entry  should be followed by an ampersand  (&)  immediately 
  99.         after  the last digit of the last code.  The ampersand (&)  tells 
  100.         PRINTER.COM  when  it has  reached the end of your  special print
  101.         features.   For  example,  if you only  had two  entries  in your 
  102.         PRINTER.DAT file it might look like:
  103.  
  104.               Compressed Print$015000
  105.               Italics Print$027053&
  106.  
  107.         Remember,  1) you can have up to 10 entries in PRINTER.DAT
  108.          
  109.                    2) each entry is comprized of:
  110.  
  111.                         a. literal followed by dollar sign
  112.                         b. followed  by two three-digit codes  (decimal
  113.                            ASCII value - not hex)  that  are to be sent   
  114.                            to the printer   (Refer  to  your  printer's
  115.                            manual for the  control codes  to set up the 
  116.                            special print features you want to use.)  If
  117.                            your  printer  manual says to  send a  alpha 
  118.                            character to the  printer,  you can find out
  119.                            what  ASCII  code should be sent by refering 
  120.                            to the IBM-PC BASIC manual appendix G.                 
  121.  
  122.                    3) The last  digit  of last code is followed  by  an 
  123.                       ampersand  (&)  so  PRINTER.COM knows when it has 
  124.                       reached the last of your special print features.  
  125.                                                                         
  126.  
  127.  
  128.  
  129.                                 Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.         The  PRINTER.DAT  file  can be created with  any  editor  (Edlin, 
  139.         Wordstar,  directly from the console, etc.).  Just be sure if you 
  140.         use  Wordstar  that you create/edit the PRINTER.DAT file  in  the 
  141.         non-document  mode.   A  sample PRINTER.DAT file  (for  an  Epson 
  142.         printer) is provided as an example.
  143.  
  144.  
  145.         PRINTER.COM  can  be  run  from Wordstar by using the  R  (run  a 
  146.         program) command from the Wordstar Menu.  For example, assume you 
  147.         just finished editing a document and have saved it.   You  should 
  148.         now  be at the Opening Menu where you normally would strike P  to 
  149.         begin printing the document.   Before printing the document,  you 
  150.         can  strike  R for run a program at which time Wordstar will  ask 
  151.         you for the name of the program you wish to run.  Type in PRINTER 
  152.         and  strike the enter key.   Note:  if PRINTER.COM is not on  the